对从同步点开始的从轴和主轴间的位置，下达一个齿轮比命令。从轴数量最多为 32。
注意：欲使用 SetGearInPos()，主轴需处于移动中以恒定速度移动。
运作方式：
首先，从轴使用 IAxis.MoveContinuousAbsolute 方法，在正确的时间及速度到达 SlaveSyncPosition，Velocity、Acceleration 与 Deceleration 输入可供 IAxis.MoveContinuousAbsolute 运动设定，运动执行时，StartSync 输出为 TRUE，一旦此运动完成，InSync 输出将为 TRUE。
GearInPos 设定档：
- 若 MasterStartDistance 非零，主轴位置一到达 MasterSyncPosition +- MasterStartDistance 时从轴即开始移动，Velocity 被视为可能无法达到的最大速度，除非速度太低，否则基本上会被省略，由于无法产生相容的设定档因此将触发错误。
- 若 MasterStartDistance 为零而 Velocity 非零，将依据提供的最大速度计算可能的最短路径设定。
- 若 MasterStartDistance 及 Velocity 皆为零，KINGSTAR 将产生一个最顺路径设定。
组合： IntervalZero.KINGSTAR.Base.Class (于 IntervalZero.KINGSTAR.Base.dll) 版本：4.4.0.0
语法
IGearInPosCommand GearInPos(
IAxis master,
bool permanent,
double ratio,
McSource masterValueSource,
double masterSyncPosition,
double slaveSyncPosition,
McSyncMode syncMode,
double masterStartDistance,
double velocity,
double acceleration,
double deceleration,
double jerk,
McBufferMode bufferMode
)Function GearInPos(
master As IAxis,
permanent As Boolean,
ratio As Double,
masterValueSource As McSource,
masterSyncPosition As Double,
slaveSyncPosition As Double,
syncMode As McSyncMode,
masterStartDistance As Double,
velocity As Double,
acceleration As Double,
deceleration As Double,
jerk As Double,
bufferMode As McBufferMode
)As IGearInPosCommand参数
master
型别：IAxis
主轴的参考。
permanent
型别：bool
决定马达停用后是否保留齿轮状态。
true：即使马达停用仍保留齿轮状态，例如当主轴启用时从轴也会跟著启用，而当主轴发生错误从轴也会发生错误。
false：马达停用后不会保留齿轮状态。
ratio
型别：double
齿轮比率。
masterValueSource
型别：McSource
定义同步的来源。请参阅 McSource。
- mcSetValue – 同步主轴设定值，建议使用此设定。
- mcActualValue – 同步主轴实际值，此设定可能不稳定。
- mcSecondEncoderValue – 轴的第二编码器的实际值。
注意：尚未支援 mcSecondEncoderValue。
masterSyncPosition
型别：double
从轴与主轴同步时主轴的位置。
slaveSyncPosition
型别：double
从轴与主轴同步时从轴的位置。
syncMode
型别：McSyncMode
定义同步的方式。
masterStartDistance
型别：double
为了与从轴同步，主轴所移动的距离（当从轴开始进入同步时）。
velocity
型别：double
同步阶段时的最大速度。
acceleration
型别：double
同步阶段时的最大加速度。
deceleration
型别：double
同步阶段时的最大减速度。
jerk
型别：double
同步阶段时的最大加加速度。
bufferMode
型别：McBufferMode
定义如何融合两方法的速度。
回传值
回传一个齿轮比率运动的属性。
备注
- 若使用 MasterStartDistance，直到主轴以正确的方向跨过 MasterSyncPosition 或 MasterStartDistance 前，任何先前的运动都会继续执行（依照 MasterStartDistance 的指示）。若在同步发生之前对从轴执行停止命令，同步将被取消且此方法将发送 CommandAborted。
- 若未指定 MasterStartDistance，则系统可根据其他相关输入计算同步设定位置。
- 在 SyncMode中，
mcCatchUp与mcSlowDown的差别在于同步所需的能量。相较于mcCatchUp，mcSlowDown需求的能量较少。
参见